home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / idccom12.zip / REDIRECT.DOC < prev    next >
Text File  |  1990-06-29  |  6KB  |  178 lines
  1.  
  2.  
  3.  
  4.                 REDIRECT.SYS
  5.                 (shareware)                
  6.  
  7.  A SERIAL PORT DEVICE DRIVER FOR REDIRECTING I/O DURING REMOTE COMMUNICATIONS
  8.  
  9.  
  10.                 Copyright 1990 Infinity Design Concepts Inc
  11.                             1052 Parkway Drive
  12.                      Louisville, Kentucky 40217-2333
  13.                 Voice: (502) 636-1234  Modem: (502) 635-5471
  14.  
  15.              Written by Gary Conway
  16.  
  17.  
  18.  WHAT IS REDIRECT FOR?
  19.  -------------------
  20.  
  21.      REDIRECT is a device driver, loaded via the config.sys file. It is
  22.     intended to be used with IDCCOM (tm), but may be used with any
  23.     communications package, running under DOS 2.x or above with full
  24.     features. With DOS versions 2.x and below, the only COM port that
  25.     may be used is COM1 and this MAY NOT be specified on the command
  26.     line, since the device driver loading routines do not support
  27.     command lines in the CONFIG.SYS file in DOS versions below 3.x.
  28.     
  29.     NOTE: Even though the filename for the device driver is
  30.           REDIRECT.SYS, the logical device installed by the
  31.           driver is named IDCDOS. It would be much nicer to have
  32.           the driver with the same name as the logical device, but
  33.           this would confuse DOS when the device driver is
  34.           loaded and then trying to copy a fresh copy of it to your
  35.           hard drive. The system will lock up since DOS becomes
  36.           extremely confused trying to figure out how to copy
  37.           to/from the IDCDOS device. This would be the same as
  38.           creating a file named AUX, PRN, CON etc. since these
  39.           are reserved names for logical devices.
  40.  
  41.     REDIRECT will display all characters that come in the selected
  42.     COM port on the local (host) screen and echo all characters sent
  43.     to the local console back to the COM port, except those that came
  44.     in the COM port as shown in the diagram below.
  45.  
  46.                     +----------+              +-------------+
  47.             |   HOST   | <------------|  COM port   |
  48.             |  SYSTEM  |              +-------------+
  49.             |  SCREEN  |                    ^
  50.             +----------+                    |
  51.                                             |  
  52.             +---------------------+         |
  53.             | HOST SYTEM KEYBOARD |---------+
  54.                     | OR PROGRAM  OR DOS  |
  55.             +---------------------+
  56.  
  57.     REDIRECT loads into memory at boot time and remains inactive until
  58.     activated by a CTTY IDCDOS command. Usually, this command will
  59.     appear in a BATCH file, when running a door program or an external
  60.     program from within the communications program. REDIRECT, will allow
  61.     the  SYSOP to monitor the activity of the caller when in the external
  62.     program.
  63.  
  64.     REDIRECT is deactivated by the CTTY CON command, again, usually in a
  65.     batch file. An example file would be..
  66.  
  67.     ECHO OFF
  68.     CLS
  69.     CTTY IDCDOS
  70.     ZIPVIEW
  71.     CTTY CON
  72.  
  73.     This would allow the communications package to execute the ZIPVIEW (tm)
  74.     program, also allowing the SYSOP to visually monitor all that
  75.     transpires.
  76.  
  77. ALTERNATE METHOD
  78. ----------------
  79.  
  80.     REDIRECT may also be used with the standard DOS redirection symbols
  81.     "<" and ">" to redirect input and output for a device or program.
  82.     All output from REDIRECT (chars from local keyboard or from serial
  83.     port) are sent to COMMAND.COM as input. All output from COMMAND.COM
  84.     is sent to REDIRECT as input, where they are in turn sent to the serial
  85.     port. Note that if using COMMAND.COM in a shell to DOS operation
  86.     from a host system, the remote system should turn on HALF DUPLEX
  87.     so that remote characters are echoed locally on the remote end.
  88.  
  89.     ECHO OFF
  90.     CLS
  91.     CTTY IDCDOS
  92.     COMMAND <IDCDOS > IDCDOS
  93.     CTTY CON
  94.  
  95.     This method causes all input and output to and from COMMAND.COM
  96.     to be run through the REDIRECT driver.
  97.  
  98.     NOTE: the above method will not work with all programs, so some
  99.           experimentation is in order, however, one of the two methods
  100.           above will definitely work.
  101.  
  102.  
  103.  
  104. LOADING REDIRECT
  105. --------------
  106.  
  107.     REDIRECT is loaded via the CONFIG.SYS file at boot time. The default
  108.     COM port for REDIRECT is COM1, but either COM1 or COM2 may be
  109.     specified on the command line, e.g.
  110.  
  111.     DEVICE=REDIRECT.SYS 2
  112.  
  113.     The above line will load REDIRECT using COM2. Note that COM1 and COM2
  114.     are hard coded to use the following,
  115.  
  116.         COM 1 = 3F8h base port address (std. COM1 location)
  117.         COM 2 = 2F8h base port address (std. COM2 location)
  118.  
  119.     Note that for COM3 and COM4 use, there is no problem as long as
  120.     the com base ports used are the same as those listed above.
  121.  
  122.     REDIRECT will work with any program that uses standard DOS input
  123.     and output functions.
  124.  
  125.  
  126. TWIT KEY
  127. --------
  128.  
  129.     The SYSOP of the host system may use the F1 key to immediately
  130.     drop the DTR signal (hang up the modem) anytime after the
  131.     CTTY IDCDOS command has been executed and up until the time
  132.     the CTTY CON command is executed. The result is that if a caller
  133.     is shelled to DOS or running a door type program, the SYSOP may
  134.     use the F1 key to terminate the call instantly, if the need arises.
  135.  
  136.  
  137. ANSI SUPPORT
  138. ------------
  139.  
  140.     The following ANSI sequences are supported directly by REDIRECT.
  141.     
  142.     CUU -  cursor up              - ESC [ Pn A
  143.     CUD -  cursor down            - ESC [ Pn B
  144.     CUF -  cursor forward         - ESC [ Pn C
  145.     CUB -  cursor backward        - ESC [ Pn D
  146.     CUP - cursor pos              - ESC [ Pl;Pc H
  147.     ED  - erase display           - ESC [ 2 J
  148.     EL  - erase line              - ESC [ K
  149.     SGR - set graphics rendition  - ESC [ Ps ; ... ; Ps m
  150.     SCP - save cursor position    - ESC [ s
  151.     RCP - restore cursor position - ESC [ u
  152.  
  153.  
  154.     REDIRECT is a shareware program. If you find yourself using REDIRECT
  155.     on a BBS system or for any other reason on a regular basis, you
  156.     are expected to register the product. REDIRECT may not be used
  157.     in any connections with commercial ventures or in for-profit
  158.     situations without registering your copy of the program.
  159.  
  160.         REGISTRATION FEE: $23.50
  161.         Site license users please call for a quotation.
  162.  
  163.  
  164. DISCLAIMER
  165. ----------
  166.  
  167.     This software and documentation are distributed on an as-is
  168.     basis and no warranty of any kind is made. IDC assumes no
  169.     responsibility as to the suitability for any purpose and
  170.     will assume no responsiblity for any damages of any kind.
  171.     The user assumes full responsiblity for any loss or damage
  172.     arising from the use or misuse of the software and/or 
  173.     documentation.
  174.  
  175.  
  176.  
  177. <end file>
  178.